Pular para o conteúdo principal

GetLivroSaldo

atenção

Gerado por Inteligência Artificial.

Visão Geral​

O método GetLivroSaldo, localizado na classe LivroCaixaBLL, é responsável por calcular e retornar o saldo consolidado do caixa de um colaborador em uma determinada data.

Ele é utilizado em fluxos de validação de saldo, fechamento de caixa, geração de extratos e exibição de dashboards.

BOX3_ERP_API.Core.BLL.LivroCaixaBLL.GetLivroSaldo
public async Task<decimal> GetLivroSaldo(int colaboradorId, DateTime data)

Dependências Diretas​

Método / AçãoDescriçãoArquivoLinha
GetLivroSaldoInternoConsulta e cálculo do saldo via LINQ/EFLivroCaixaBLL.cs630

Detalhamento da Dependência​

GetLivroSaldoInterno​

  • Realiza a consulta do somatório das entradas e saídas até a data solicitada.
  • Utiliza Entity Framework para acessar LivroCaixa.
  • Executa:
    • Where com filtros de colaboradorId e data
    • SumAsync para calcular o saldo consolidado
  • Pode retornar zero em casos sem movimentação

Chamadores Diretos​

MétodoLocalizaçãoLinha
ConsultarSaldoAtual(int)CaixaResumoController.cs88
FechamentoCaixaAsync(...)LivroCaixaOperadorBLL.cs612

Detalhamento dos Chamadores​

CaixaResumoController.ConsultarSaldoAtual​

  • Endpoint exposto via API para exibir o saldo atual do operador de caixa no frontend.

LivroCaixaOperadorBLL.FechamentoCaixaAsync​

  • Utiliza GetLivroSaldo para calcular o saldo final durante o processo de fechamento do caixa.

Impacto de Alterações​

Qualquer modificação em GetLivroSaldo afeta:

  • Visualizações em tela (painéis de saldo)
  • Fechamento de caixa e suas validações
  • Exportação de extratos
  • Conferência de movimentações históricas

Propagação de Mudanças​

Se modificar este método, valide:

  • Precisão nos filtros de data e colaborador
  • Integridade dos dados ao usar SumAsync
  • Performance em caixas com alto volume de lançamentos

Requisitos para Alteração Segura​

  • Validar retorno correto para múltiplos cenários (com e sem lançamentos)
  • Realizar testes com datas de corte distintas
  • Testar integração com tela de saldo e fechamento

Conclusão Técnica​

O método GetLivroSaldo é fundamental para a confiabilidade dos saldos exibidos no sistema, influenciando tanto a experiência do usuário quanto a segurança nos fechamentos financeiros.

Alterações devem ser feitas com cautela e acompanhadas de testes de integração e carga, garantindo precisão e desempenho.